开票状态回传 | 商户->百度

开票状态回传【百度即时请求商户】

接口地址
线下:http://test.carowner.baidu.com/map_mc/preorder/callbackinvoice
线上:https://maphotel.baidu.com/map_mc/preorder/callbackinvoice

接口描述

回传用户开发票信息

权限说明

为确保对内外请求安全性,添加公共参数并对公共参数进行统一验签,对于百度请求商户,百度在请求参数中添加以下公共参数,对于商户数据推送百度,在推送json数据体最外层key中也添加以下公共参数(详细见各推送数据样例)。

字段名 类型 长度 必填 释义
1 tp_name string 64 渠道号,开发前分配渠道号和私(primary_key),请妥善保管
2 timestamp int 10 秒时间戳
3 salt string 64 随机串
4 sign string 64 签名,签名规则 md5(tp_name + timestamp + salt + primary_key),单纯参数值(不含参数名)拼接,不需要加入参数名

请求参数

字段名 类型 长度 必填 释义
1 bd_pre_order_id string 64 百度预支付单号
2 bd_pay_order_id string 64 百度支付单号
3 tp_order_id string 64 供应商单号
4 invoice_status string 64 开票状态 1:开票成功 2:开票失败 3:已邮寄
5 invoice_img_link string 64 发票图片
6 extra jsonstring 64 扩展字段
7 公共参数 - - 公共参数参考公共参数部分

响应参数

字段名称 字段说明 字段要求 字段类型 长度
1 errno 错误码 0,success string -
2 msg 错误描述 0,success string -
3 data 详情信息 string -

请求示例

{
    "tp_name":"test",
    "timestamp":1704943679,
    "salt":"2jk3",
    "sign":"111"
    "bd_pay_order_id":"test_123456", // 百度支付单号
    "tp_order_id":"123456",// 供应商单号
    "invoice_status":1,  // 发票状态
    "invoice_img_link":"http://" // 图片地址
    "extra":{
        "invoice_fail_reason":"xxx", // 开票失败原因
    }
}

响应示例

正常
{"errno":0,"msg":"success","data":""}
联运商户与百度用户打通支付中心